MacFormat 1997 February/macformat-047.iso/Shareware Plus/Developers/PlayerPRO 4.5.3 Dev.Kit/MADH Library 4.2/Libraries & Headers/PPPlug.h

C/C++ Source or Header | 1996-07-02 | 9.1 KB | 254 lines | [TEXT/CWIE]

#ifndef __PPPLUGH__
#define __PPPLUGH__

#ifndef __RDRIVERH__
#include "RDriver.h"
#endif

#if defined(powerc) || defined (__powerc)
#pragma options align=mac68k
#else
#if !defined(THINK_C)
#pragma options align=mac68k
#endif
#endif


/********************                        ***********************/
//
//    Player PRO 4.5x --    Plugs SOUND FILTERS Definition
//                        Plugs DIGITAL EDITOR Definition
//                        Plugs INSTRUMENTS IMPORT/EXPORT Definition
//
//    Version 3.0
//
//    To use with PlayerPRO & CodeWarrior ( current vers 8)
//
//    Antoine ROSSET
//    16 Tranchees
//    1206 GENEVA
//    SWITZERLAND
//
//    FAX:            ([phone]
//    Compuserve:        100277,164
//    Phone:            ([phone]
//    Internet:         [e-mail]
/********************                        ***********************/



/******************************************************************/
//    *****************    FILTERS FOR SAMPLES/SOUNDS    ***************/
//
//    Your main function have to be in this form:
//    OSErr main(     sData                    *theData,                    // Sample informations, see MAD.h
//                    long                    SelectionStart,                // SelectionStart
//                    long                    SelectionEnd,                // SelectionEnd, your filter SHOULD apply his effect only on the selection
//                    PPInfoPlug                *thePPInfoPlug)                // Some functions of PlayerPRO that you can use in your plugs
//
//
//    *****************                        ***********************/
//
//    If you want to reallocate theData or theData->data:
//
//    if( theData->data != 0L) DisposPtr( theData->data);        // VERY IMPORTANT to free memory
//    theData->data = NewPtr( newsize);                        // Use NewPtr ONLY to allocate memory!
//
//    theData->size = newsize;                                // In bytes !! Even for 16 bits !
//
//    Don't forget to UPDATE the theData->size !!!!!!!!!!!!
//
//    *****************                        ***********************/
//
//    About Resources:
//
//    Your Plug should have: Creator: 'SNPL', Type: 'PLug'
//
//    Your Plug have to have these resources:
//
//    - One resource CODE 1000 with 68k Code  ** You should NOT use the 68881 coprocessor **
//    - One resource PPCC 1000 with PPC Code  (OPTIONAL: if PlayerPRO PPC version cannot find it, it will use the CODE 1000 68k resource)
//    - One STR# resource :
//
//        1 string: Menu Name (see Instrument window in PlayerPRO)
//
/********************                        ***********************/

typedef struct
{
    void        *RPlaySoundUPP;            //    OSErr            RPlaySound( Ptr whichSound, long SoundSize, long whichTrack, long Period, long Amplitude, long loopStart, long loopLength)
    void        *UpdateALLWindowUPP;    //    void            UpdateALLWindow( void)
    void        *MyDlgFilterUPP;        //    pascal Boolean    MyDlgFilter( DialogPtr theDlg, EventRecord *theEvt, short *itemHit)

} PPInfoPlug;

typedef OSErr            (*RPlaySoundUPP)        ( Ptr, long, long, long, long, long, long, unsigned long);
typedef void            (*UpdateALLWindowUPP)    ( void);
typedef pascal Boolean    (*MyDlgFilterUPP)        ( DialogPtr, EventRecord*, short*);


#if defined(powerc) || defined(__powerc)

#include "mixedmode.h"

        /****** POWERPC calls *********/

#define         RPlaySoundCallMode (    kCStackBased|\
                RESULT_SIZE( SIZE_CODE( sizeof(OSErr) ))|\
                STACK_ROUTINE_PARAMETER( 1, SIZE_CODE( sizeof( Ptr)))|\
                STACK_ROUTINE_PARAMETER( 2, SIZE_CODE( sizeof( long)))|\
                STACK_ROUTINE_PARAMETER( 3, SIZE_CODE( sizeof( long)))|\
                STACK_ROUTINE_PARAMETER( 4, SIZE_CODE( sizeof( long)))|\
                STACK_ROUTINE_PARAMETER( 5, SIZE_CODE( sizeof( long)))|\
                STACK_ROUTINE_PARAMETER( 6, SIZE_CODE( sizeof( long)))|\
                 STACK_ROUTINE_PARAMETER( 7, SIZE_CODE( sizeof( long)))|\
                 STACK_ROUTINE_PARAMETER( 8, SIZE_CODE( sizeof( unsigned long))))

#define CallRPlaySoundUPP( v1, v2, v3, v4, v5, v6, v7, v8)        \
        CallUniversalProc( thePPInfoPlug->RPlaySoundUPP, RPlaySoundCallMode, v1, v2, v3, v4, v5, v6, v7, v8)

/**/

#define UpdateALLWindowCallMode (    kCStackBased)

#define CallUpdateALLWindowUPP()        \
        CallUniversalProc( thePPInfoPlug->UpdateALLWindowUPP, UpdateALLWindowCallMode)

/**/

#else    /******** 68K calls ***********/

#define CallRPlaySoundUPP( v1, v2, v3, v4, v5, v6, v7, v8)        \
        (* (RPlaySoundUPP) (thePPInfoPlug->RPlaySoundUPP))( v1, v2, v3, v4, v5, v6, v7, v8)

/**/

#define CallUpdateALLWindowUPP()        \
        (* (UpdateALLWindowUPP) (thePPInfoPlug->UpdateALLWindowUPP))

/**/
#endif

/********************                        ***********************/
//
//
// RPlaySoundUPP    : See Developper Toolkit documentation. Play a SoundPtr at a specific Period by using PlayerPRO Driver.
// UpdateALLWindow    : Check all PlayerPRO windows and update them if need it.
// MyDlgFilterUPP    : to use with a ModalDialog function: allow movable dialog, PlayerPRO windows updating, Item 1 Frame, Copy/Paste support, Key support
//
//
/********************                        ***********************/


/******************************************************************/
//******************* DIGITAL EDITOR PLUGS  ***********************/
//
//    Your main function have to be in this form:
//    OSErr main(     Pcmd                    *Pcmd,                        // Digital Selection
//                    PPInfoPlug                *thePPInfoPlug)                // Some functions of PlayerPRO that you can use in your plugs
//
//
//    *****************                        ***********************/
//
//    If you want to reallocate Pcmd:
//
//    if( Pcmd != 0L) DisposPtr( (Ptr) Pcmd);                            // VERY IMPORTANT
//    Pcmd = NewPtrClear( sizeof( Pcmd) + noCell * sizeof( Cmd));        // Use NewPtr ONLY to allocate memory!
//
//    myPcmd->structSize     = sizeof( Pcmd) + noCell * sizeof( Cmd);
//
//    Don't forget to UPDATE the myPcmd->structSize !!!!!!!!!!!!
//
//    *****************                        ***********************/
//
//    About Resources:
//
//    Your Plug should have: Creator: 'SNPL', Type: 'PPDG'
//
//    Your Plug have to have these resources:
//
//    - One resource CODE 1000 with 68k Code  ** You should NOT use the 68881 coprocessor **
//    - One resource PPCC 1000 with PPC Code  (OPTIONAL: if PlayerPRO in PPC cannot find it, it will use the CODE 1000 resource)
//    - One STR# resource :
//
//        1 string: Menu Name (see Button in Digital Editor window in PlayerPRO)
//
/********************                        ***********************/

typedef struct
{
    short            tracks;                    // number of tracks in myCmd[]
    short            length;                    // number of rows in myCmd[]
    short            trackStart;                // track ID of first track in myCmd[]
    short            posStart;                // row ID of first row in myCmd[]
    long            structSize;                // struct size in bytes - see Definition
    Cmd                myCmd[];
} Pcmd;

/******************************************************************/
//******************* INSTRUMENTS IMPORT/EXPORT PLUGS  ************/
//
//    Your main function have to be in this form:
//    OSErr main(     OSType                    order,                        // Order to execute
//                    InstrData                *InsHeader,                    // Ptr on instrument header
//                    sData                    **sample,                    // Ptr on samples data
//                    short                    *sampleID,                    // If you need to replace/add only a sample, not replace the entire instrument (by example for 'AIFF' sound)
//                                                                        // If sampleID == -1 : add sample else replace selected sample.
//                    FSSpec                    *AlienFile,                    // IN/OUT file
//                    PPInfoPlug                *thePPInfoPlug)                // Some functions of PlayerPRO that you can use in your plugs
//
//
//    *****************                        ***********************/
//    Actual plug have to support these orders:
//
//    order: 'TEST':    check the AlienFile to see if your Plug really supports it.
//    order: 'IMPT':    convert the AlienFile into a PlayerPRO instrument. You have to allocate/dispose your sData*. NOT InsHeader!
//    order: 'EXPT':    Convert current instrument&samples into a file.
//    order: 'PLAY':    Play the sound file at base note via PlayerPRO driver in SYNC.
//    *****************                        ***********************/
//
//    About Resources:
//
//    Your Plug should have: Creator: 'SNPL', Type: 'PPIN'
//
//    Your Plug have to have these resources:
//
//    - One resource CODE 1000 with 68k Code  ** You should NOT use the 68881 coprocessor **
//    - One resource PPCC 1000 with PPC Code  (OPTIONAL: if PlayerPRO in PPC cannot find it, it will use the CODE 1000 resource)
//    - One STR# resource :
//
//
//        1 string: which kind of files your plug support (OSType value !!! 4 char) By example: 'WAVE', 'snd ', 'AIFF', etc...
//        2 string: what does your Plug: EXPL : only Export files, IMPL : only Import Files, EXIM : import AND export.
//        3 string: string that will be used in Import and Export menu of PlayerPRO
//        4 string: Copyright string of this plug.
//        5 string: Is it a sample or an instrument format? 'INST' or 'SAMP'
//
/********************                        ***********************/

OSErr    PPINImportFile( OSType    kindFile, short ins, short *samp, FSSpec    *AlienFile);
OSErr    PPINTestFile( OSType    kindFile, FSSpec    *AlienFile);
OSErr    PPINExportFile( OSType    kindFile, short ins, short samp, FSSpec    *AlienFile);
OSType    PressPPINMenu( Rect    *PopUpRect, OSType curType, short, Str255);
OSErr    PPINAvailablePlug( OSType    kindFile, OSType *plugType); // plugType == 'INST' or 'SAMP'
OSErr    PPINGetPlugByID( OSType *type, short id, short samp);


// SndUtils.c Definition :

sData*    MADCreateSample();
OSErr    AddSoundToMAD(    Ptr, long, long, short, short, unsigned long, Str255, InstrData*, sData**, short*);
Ptr     MyExp1to6( Ptr sound, unsigned long numSampleFrames);
Ptr     MyExp1to3( Ptr sound, unsigned long numSampleFrames);
void     ConvertInstrumentIn( register    Byte    *tempPtr,    register long sSize);



#if defined(powerc) || defined (__powerc)
#pragma options align=reset
#else
#if !defined(THINK_C)
#pragma options align=reset
#endif
#endif
#endif